Merging projects

When merging projects you can reuse resources and objects you created in another project. Merging projects allows you to import a complete project or only selected resources and objects. During merging Kanzi provides conflict resolution.

Kanzi provides these options for bringing content from other projects:

• You can bring an entire project to the current project. See Importing projects.
• You can merge 3D assets from a 3D asset file. See Merging 3D assets.
• You can bring to the current project only a part of another project. See Using content from another Kanzi Studio project.
• If you want to import the content your created with third-party tools, use Kanzi Studio importing tools. See Importing.

Merging projects

To merge projects:

1. Select File > Import > Merge Project, select the project you want to merge (source project) to the currently open project (target project), and click Open.
   Project Merge window opens.
2. In the Project Merge window set:
   • Check referenced items. Select the checkbox when you want Kanzi Studio to automatically select all items to which the selected item refers.
     For example, when you check the Check referenced items checkbox and select a mesh that has a material, Kanzi Studio studio automatically selects the material, material type, and shaders used by the mesh you selected.
   • Transformations. If Kanzi Studio encounters a conflict in object transformations when an object in the target is replaced with an object from the source, select:
     • Keep transformations from the target to keep the object transformations you use in the target. Kanzi Studio remembers all transformation changes you made to the objects in Kanzi Studio.
     • Keep transformations from the source to import the object transformations you use in the source.
   • Materials. If Kanzi Studio encounters a conflict in object materials when an object in the target is replaced with an object from the source, select:
     • Keep materials from the target to keep the materials you use for the objects in the target. Kanzi Studio remembers all material changes you made to the objects in Kanzi Studio.
     • Keep materials from the source to import the materials you use for the objects in the source.
3. Select the checkboxes next to the items you want to merge from the source to target. Depending on the existence of the selected item in the target project, the name of the item is written using:
   • White font. Items exist in the source, but not in the target. When you select such items, Kanzi Studio creates them in the target.
   • Grey font. Items exist in both the source and target, and are identical in both.
   • Red font. Items exist in both the source and target, but differ between the two.
     Before you can continue with the merging, you have to resolve conflicts by choosing to use either the item in the target or the source.
   • Purple font. Items exist in the target, but not in the source. When you select such items, Kanzi Studio removes them form the target.
4. Resolve conflicts. When your target and source both contain the same item and properties of this item differ, you have to decide which properties you want to keep:
   • Click Resolve to source to use the values in the source to resolve all conflicts.
   • Click Resolve to target to use the values in the target to resolve all conflicts.
   • Click Use base project to select a base project for resolving conflicts between the target and the source. For example, Use base project is useful when you are merging two projects or assets that are modifications of an initial project.
     When using three-way merge, this is how conflict resolution works in Kanzi Studio:
     • If the difference is only between the base project and the target, Kanzi Studio uses the change in the target.
     • If the difference is only between the base project and the source, Kanzi Studio uses the change in the source.
     • If the change is between both the base project and the target, and the source and the target, you have to resolve the conflict.
   • To resolve conflicts manually, select the item in the source tree and in the conflicts pane select whether you want to keep the value used in the target or the source.
5. Click Merge.
   Kanzi Studio merges the source with the target by placing the content of source into the corresponding places of the target.

Merging projects using version control tools

After configuring your version control tool you can use the Kanzi merge tool for Kanzi project updating and merging. For the integration Kanzi requires a version control tool that provides the necessary parameters to the Kanzi merge tool.

Integrating the Kanzi merge tool with a version control tool

To integrate the Kanzi merge tool with a version control tool:

1. Configure your version control tool to use the Kanzi merge tool (<KanziInstallation>/Studio/Bin/KanziMergeTool.bat) for .kzproj files.
2. Pass to your version control tool the absolute path to the KanziStudio.exe. For example, C:\Program Files (x86)\Rightware\Kanzi\Studio\Bin\KanziStudio.exe.
3. Set the version control tool parameters for the Kanzi merge tool. For example, these parameters can be called MINE, THEIRS, BASE, MERGED.

Integrating the Kanzi merge tool with SVN version control software

To integrate the Kanzi merge tool with SVN version control software, open the SVN settings and add Kanzi merge tool as an external program for merging files with the .kzproj extension.
For example, if you are using Tortoise SVN, open these settings by going to SVN > Settings > External Programs > Merge Tool > Advanced and set:

• Filename, extension or mime-type to .kzproj
• External program to
  

  <KanziInstallation>/Studio/Bin/KanziMergeTool.bat "<KanziInstallation>/Studio/Bin/
  	KanziStudio.exe"  %mine %theirs %base %merged

  
  For example, if your installation of Kanzi is in C:\Program Files (x86)\Rightware\Kanzi, use
  

  C:\Program Files (x86)\Rightware\Kanzi\Studio\Bin\KanziMergeTool.bat "C:\Program Files
  	 (x86)\Rightware\Kanzi\Studio\Bin\KanziStudio.exe" %mine %theirs %base %merged

See also

Importing projects

Merging 3D assets

Projects

Using version control systems with Kanzi

Open topic with navigation